home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / comm / mmgr / MM_AmiHatch.readme < prev    next >
Text File  |  1997-01-05  |  14KB  |  459 lines
  1. Short:    MM_AmiHatch v0.59  Hatch Mirrorfiles via MM
  2. Author:   McB@Fido.de ( Ulrich Lammers  PmnS BBs )
  3. Uploader: aliberti@mbox.vol.it (Pino Aliberti)
  4. Version:  0.59
  5. Type:     comm/mmgr
  6. Replaces: comm/mmgr/MM_Amihatch.lha
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                   L   L  L   L
  13.                                   LL LL  LL LL
  14.                                   L L L  L L L
  15.                                   L   L  L   L
  16.                                   L   L  L   L
  17.  
  18.  
  19.                 LLL   L   L  LLL  L   L   LLL   LLLLL   LLL   L   L
  20.                L   L  LL LL   L   L   L  L   L    L    L   L  L   L
  21.                LLLLL  L L L   L   LLLLL  LLLLL    L    L      LLLLL
  22.                L   L  L   L   L   L   L  L   L    L    L   L  L   L
  23.                L   L  L   L  LLL  L   L  L   L    L     LLL   L   L
  24.  
  25.  
  26.                            L   L  LL     LLLL  LLLL
  27.                            L   L L  L    L     L  L
  28.                            L   L L  L    LLL   LLLL
  29.                             L L  L  L       L     L
  30.                              L    LL  L  LLL   LLLL
  31.  
  32.  
  33.  
  34.  
  35.                          (C)  1996  ULRICH LAMMERS
  36.                           Alle Rechte vorbehalten
  37.  
  38.         Dieses Arexx-Script benötigt den MailManager von Pino Alberti
  39. ------------------------------------------------------------------------------
  40.  
  41.  
  42.  
  43.  1. Einführung
  44.  =============
  45.  
  46.   1.1 Rechtliches
  47.   ---------------
  48.  
  49.    MM_AmiHatch ist ein Utility für den Mail Manager von Pino Aliberti um die
  50.    AMINet-Archive aus dem InterNet mit ihren RENAMING-Files besser handeln zu
  51.    können.
  52.    Für diejenigen, die Ihr System als AmiNet-Mirror nutzen, ist das eine
  53.    enorme Arbeitserleichterung, das die gesamte Verarbeitung der
  54.    aminet_xxxxx_xxxxx.lha sowie der ___RENAMING_xxxxx_xxxxx von dem Script
  55.    übernommen wird.
  56.  
  57.    Die Programme und Dateien dieses Archives sind frei kopierbar, das Copyright
  58.    liegt allerdings bei © Ulrich Lammers. Das Archiv darf frei weitergegeben
  59.    und verbreitet werden, solange dafür nicht mehr Geld verlangt wird, als für
  60.    das Kopieren notwendig ist.
  61.  
  62.    Eine kommerzielle Nutzung ist ohne die schriftliche, vorherige Erlaubnis des
  63.    Autors verboten. Dieses Archiv und alle seine Einzeldateien müssen
  64.    unverändert bleiben, es dürfen keine Veränderungen oder Erweiterungen
  65.    vorgenommen werden.
  66.  
  67.    MM_AmiHatch ist Mailware :-). Das bedeutet, wenn Du dieses Programm länger
  68.    als dreißig Tage nutzt, schicke dem Programmierer bitte eine kurze Mail,
  69.    dass Du dieses Programm nutzt. In dieser dürfen auch kritische Anmerkungen
  70.    und Feature-Requests enthalten sein... es ist frustrierend Programme zu
  71.    schreiben von denen man nicht weiß ob sie jemand nutzt, ob sie Sinn machen
  72.    oder nicht.
  73.  
  74.    Die einzige Bedingung um MM_AmiHatch zu nutzen, ist die Beachtung dieser
  75.    wenigen Auflagen.
  76.  
  77. ==============================================================================
  78.    Der Autor ist für irgendwelche aus der Nutzung dieses Programms
  79.    resultierenden Probleme oder Datenverluste NICHT verantwortlich.
  80. ==============================================================================
  81.  
  82.  
  83.   1.2 Generelles
  84.   --------------
  85.  
  86.    Dieses ist mein erstes veröffentlichtes ARexx-Programm für den MailManager.
  87.    Sicherlich können noch einige Optimierungen, neue Features etc. Einzug
  88.    finden. Also seid bitte nicht zu hart in Eurer Beurteilung. Seinen Zweck
  89.    erfüllt es allemal und das sogar sehr gut. (auf meinem System zumindest..)
  90.  
  91.  
  92.   1.3 Autor
  93.   ---------
  94.  
  95.    Wenn Du irgendwelche Verbesserungsvorschläge oder Probleme mit diesem
  96.    Programm hast, vielleicht sogar einen nicht existenten Bug gefunden hast, so
  97.    lasse es mich wissen.
  98.  
  99.    Zu erreichen bin ich folgendermassen:
  100.  
  101.       Ulrich Lammers
  102.       Alter Pferdemarkt 3       39:178/0.0@AmigaNet
  103.       49808 Lingen               2:2426/4065.0@FidoNet
  104.       Telefon 0591/9150115
  105.  
  106.  
  107.  
  108.  2. Features
  109.  ===========
  110.  
  111.   MM_AmiHatch...
  112.  
  113.      ... zerlegt die aminet.xxxxx.xxxxx.lha Files in Ihre Komponenten,
  114.          führt ein automatisches Renaming durch und kopiert die Files in Ihr
  115.          passendes Zielverzeichnis.
  116.      ... hatched alle neuankommenden Files für angeschlossene Nodes/Points nach
  117.          Massgabe des MM_Config Files
  118.      ... erstellt nicht existente TickAreas nach Vorgabe
  119.      ... erstellt AutoLinks für neue TickAreas
  120.      ... erstellt Zielverzeichnis in Baumstruktur oder flach, was von einigen
  121.          BBS-Systemen (Excelsior!) gefordert wird.
  122.      ... erstellt NewArea-Announces in beliebig vielen Areas
  123.      ... kann Einträge von neuen Areas in die FFRS-Konfiguration vornehmen
  124.  
  125.  
  126.  
  127.  3. Installation
  128.  ===============
  129.  
  130.   1. Kopiere die Dateien in die entsprechenden MM: Verzeichnisse
  131.  
  132.   2. Verändere die .CFG nach Deinem Gusto.
  133.  
  134.   3. Füge ein rx MM:Rexx/MM_AmiHatch bei Deinem TIC-Import ein. Ich empfehle die
  135.      Nutzung von MM_ImportPlus (© Robert Hofmann) "#TICKCMD..."
  136.  
  137.  
  138.  
  139.  4. Benutzung
  140.  ============
  141.  
  142.   [RX] MM_AmiHatch[.rexx]
  143.  
  144.   Wie dem geneigten Nutzer vielleicht aufgefallen ist, befindet sich ein
  145.   weiteres Script in der Distribution, nämlich "MM_AmiHatch". Das ist ein
  146.   Ausführbares Programm, das mit CompressRexx2.1 erstellt wurde. Es lässt sich
  147.   wie ein normales Programm starten, BENÖTIGT ABER TROTZDEM AREXXMAST zur
  148.   Funktion.
  149.  
  150.  
  151.  
  152.  
  153.  5. Konfiguration
  154.  ================
  155.  
  156.  
  157.   Im folgenden sind alle Konfigurationsparameter einzeln erläutert. Schau Dir
  158.   bitte die Beispiel-Konfiguration genau an!!
  159.  
  160.  
  161.     5.1 #INBOUND    DIR/A
  162.     ---------------------
  163.  
  164.     Pfad zu Deinem Verzeichnis, in dem die aminet_xxxxx_xxxxxx.lha und
  165.     ___RENAMING.xxxxx.xxxxx Dateien liegen.
  166.  
  167.     Bsp.: #INBOUND  Work:Aminet_Hold/
  168.  
  169.  
  170.     5.2 #WORKDIR    DIR/A
  171.     ---------------------
  172.  
  173.     Das Arbeitsverzeichnis für MM_AmiHatch, in dem die Archive ausgepackt werden. 
  174.  
  175.     Bsp.: #WORKDIR  UNARC:
  176.  
  177.  
  178.  
  179.     5.3 #DESTINATIONPFAD    DIR/A
  180.     -----------------------------
  181.  
  182.     Hier werden die (neuanzulegenden) TickAreas erstellt.
  183.  
  184.     Bsp.: #DESTINATIONPFAD  Aminet:
  185.  
  186.  
  187.  
  188.     5.4 #ARCHIVEPREFIX      NAME/A
  189.     ------------------------------
  190.  
  191.     Das ist der Namensprefix der zu bearbeitenden AmiNet-Archive.
  192.  
  193.     Bsp.: #ARCHIVEPREFIX    aminet_
  194.  
  195.  
  196.  
  197.  
  198.     5.5 #BACKUPDIR      DIR/A
  199.     -------------------------
  200.  
  201.     Der Pfad zum BackUp-Directory, wo verarbeitete Archive und ___RENAMING-Files
  202.     abgelegt werden. Ohne Namensangabe werden die Files einfach gelöscht.
  203.  
  204.     Bsp.: #BACKUPDIR    AminetBCK:
  205.  
  206.  
  207.  
  208.  
  209.     5.6 #AUTOLINKNODE <Node>[<Node> <Node> <Node>...]
  210.     -------------------------------------------------
  211.  
  212.     Hier werden alle Nodes/Points, also Systeme eingetragen, welche die NEU
  213.     ERSTELLTEN Areas als Autolink sofort erhalten sollen (z.B. Downlinks die
  214.     ebenfalls AmiNet-Mirror sind)
  215.  
  216.     Bsp.: #AUTOLINKNODE 39:170/1 110 178/111 .1 .12
  217.  
  218.     Hierbei würden die Nodes 39:170/1, 39:170/110, 39:178/111 sowie die Points .1 und .12
  219.     von 39:178/111 die neuen Areas erhalten.
  220.  
  221.  
  222.  
  223.  
  224.     5.7 #HATCHNODE      <Node>/A
  225.     ----------------------------
  226.  
  227.     Dieses ist die Absende-Adresse des Systems für die TIC-Files.
  228.  
  229.     Bsp.: #HATCHNODE    39:178/1.0@AmiNet
  230.  
  231.  
  232.  
  233.     5.8 #GROUP      <gruppe>
  234.     ------------------------
  235.  
  236.     Die Gruppe, die in dem neuen TickArea Eintrag im MM_CFG eingetragen
  237.     werden soll. Muß eine gültige Gruppe der MM_CFG sein.
  238.  
  239.     Bsp.: #GROUP    AMINET
  240.  
  241.  
  242.  
  243.  
  244.     5.9 #LEVEL      <num>
  245.     ---------------------
  246.  
  247.     Der Level, der in dem neuen TickArea Eintrag im MM_CFG eingetragen werden
  248.     soll.
  249.  
  250.     Bsp.: #LEVEL    50
  251.  
  252.  
  253.  
  254.  
  255.     5.10 #NEWAREA   [Tree|NoTree]
  256.     -----------------------------
  257.  
  258.     Hiermit wird festgelegt, wie die Verzeichnisstruktur der neuen TIC-Areas
  259.     auszusehen hat. Es gibt zwei Möglichkeiten:
  260.  
  261.       TREE   - Die Verzeichnisse werden wie im AmiNet üblich mit
  262.                Unterverzeichnissen angelegt. Also z.B.: AmiNet:COMM/BBS/
  263.                Das ist wohl die Standardeinstellung.
  264.  
  265.       NOTREE - Die Verzeichnisse werden OHNE Unterverschachtelungen im
  266.                Zielverzeichniss angelegt. Das ist für die Verwendung mit einigen
  267.                BBS-Paketen (z.B. Excelsior!) erforderlich, da diese keine
  268.                verschachtelten FileBase-Verzeichnisse unterstützen.
  269.                Also z.B. : AmiNet:COMM_BBS/
  270.  
  271.      Bsp.: #NEWAREA TREE
  272.  
  273.  
  274.  
  275.  
  276.     5.11 #KUTTAREAWITH          <Trenner>
  277.     -------------------------------------
  278.  
  279.     Wenn bei #NEWAREA NoTree angegeben wurde, kann hier ein Trennzeichen für die
  280.     Betitelung der Area-Directories angegeben werden.
  281.  
  282.     Bsp.: #KUTTAREAWITH  _               'ist gleich --> AMINET:COMM_BBS/'
  283.           #KUTTAREAWITH  .               'ist gleich --> AMINET:COMM.BBS/'
  284.  
  285.  
  286.  
  287.  
  288.     5.12 #ANNOUNCEAREA      <AreaName>
  289.     ----------------------------------
  290.  
  291.     Hiermit kann man angeben, in welche Area die Announcements für die
  292.     Erstellung einer neuen Area geleitet werden sollen. es muß eine
  293.     existierende Area vom MailManager sein.
  294.  
  295.     Bsp.: #ANNOUNCEAREA     PmnS.Info
  296.           #ANNOUNCEAREA     Amy_Newfiles.Ger
  297.           #ANNOUNCEAREA     AMYREQ.Ger
  298.           [....]
  299.  
  300.  
  301.  
  302.     5.12.1 '%' Befehle in (Report.txt) | (Area.HDR)
  303.     -----------------------------------------------
  304.     Mit den '%' Befehlen kann der Report-text und Area-Header
  305.     fuer neue AREAS und Newfiles an deine Beduerfnisse angepasst werden.
  306.  
  307.     Moegliche Befehle :
  308.                         %AR         Name  der neuen AREA
  309.                         %LE         Level der neuen AREA
  310.                         %GR         Group der neuen AREA
  311.  
  312.  
  313.  
  314.  
  315.     5.13 #FILEREQUESTSERVER     [FFRS|NONE]
  316.     ---------------------------------------
  317.  
  318.     Hiermit können neue Areas gleich dem FileRequestserver FFRS mitgeteilt
  319.     und freigeschaltet werden. Die .CFG von FFRS wird, sofern der Pfad bei
  320.     #REQUESTSERVERCFG angegeben ist automatisch geändert.
  321.     Es existieren zwei Schlüsselworte, die sich gegenseitig ausschliessen:
  322.         FFRS - Neue Areas werden FFRS mitgeteilt und eingebunden
  323.         NONE - FFRS wird nicht beeinflusst.
  324.  
  325.     Bsp.: #FILEREQUESTSERVER    FFRS
  326.  
  327.  
  328.  
  329.  
  330.     5.14 #REQUESTSERVERCFG      <Pfad>
  331.     ----------------------------------
  332.  
  333.     Wenn bei #FILEREQUESTSERVER FFRS eingetragen wurde, kann man jetzt den Pfad
  334.     zu der .CFG von FFRS angeben. Ansonsten hat dieser Eintrag keine Funktion.
  335.  
  336.     Bsp.: #REQUESTSERVERCFG     FFRS:FFrs_1.Cfg
  337.  
  338.  
  339.  
  340.  
  341.     5.15 #UNARC <Endung> <Packer> [Parameter]
  342.     --------------------
  343.  
  344.     Packer um eingehende Mirrrorfiles zu entpacken.
  345.  
  346.     Bsp.: #UNARC              LHA  C:Lha x -E
  347.  
  348.  
  349.  
  350.  
  351.     5.16 #LONGDESC [DESC]
  352.     ---------------------
  353.  
  354.     Beschreibung fuer Readme-files
  355.  
  356.     Bsp.: #LONGDESC             Long Description for
  357.  
  358.  
  359.  
  360.  
  361.  
  362.     5.17 #AREAMODE <LONG|SHORT>
  363.     ---------------------------
  364.     AreaMode ist ein Schalter, um neue Areas in zwei Versionen zu generieren.
  365.  
  366.     SHORT =  COMM.BBS
  367.     LONG  =  AMINET.COMM.BBS
  368.  
  369.     Bsp.: #AREAMODE             LONG
  370.  
  371.  
  372.  
  373.  
  374.     5.18 #CREATEFILELIST  <YES|NO>
  375.     -----------------------------
  376.  
  377.     Die Funktion ist der Schalter,fuer das Posten der Newfiles nach dem Hatchen
  378.  
  379.     Bsp.: #CREATEFILELIST        YES
  380.  
  381.  
  382.  
  383.  
  384.     5.19 #FROMSYSOP [Name]
  385.     ----------------------
  386.  
  387.     Die Funktion fuegt einen Absender zum Newfiles-Announce
  388.  
  389.     Bsp.: #FROMSYSOP      MM_Amihatch
  390.  
  391.  
  392.  
  393.  
  394.     5.20 #ANNOUNCEFILELIST <Area><Betr>,<Empf>,[Header],[Footer]
  395.     -------------------------------------------------------------------
  396.  
  397.     Announcen der Newfiles in den angegeben Areas.
  398.  
  399.     Area   =  Area, in die, die Newfiles gepostet werden sollen
  400.     Betr   =  Betreffzeile fuer die Newfiles
  401.     Empf   =  Empfaenger der Newfiles z.b. (All, Alle...)
  402.     Header =  Path zum Header der Newfiles
  403.     Footer =  Path zum Footer der Newfiles
  404.  
  405.     (Jeder Befehl MUSS durch ein komma ',' getrennt werden)
  406.  
  407.     Bsp.: #ANNOUNCEFILELIST   Amy_Newfiles.Ger,Aminet Newfiles,All,MM:Config/MM_Amihatch/Aminet.Header,MM:Config/MM_Amihatch/Aminet.Footer
  408.           #ANNOUNCEFILELIST   PmnS.Newfiles,Aminet Newfiles der PmnS,All,,
  409.           [....]
  410.  
  411.  
  412.     5.21 #TICKCOMMAND <Befehl>
  413.     -------------------------------------------------------------------
  414.  
  415.     Diese Funtion bindet automatisch einen TickCommand fuer neue Areas in MM ein.
  416.  
  417.     Bsp.: #TICKCOMMAND  AMINET
  418.  
  419.  
  420.  
  421.  
  422.  6. Ackknowledgements
  423.  ====================
  424.  
  425.     Hier der Dank an die, die dieses Script ermöglicht haben :
  426.  
  427.     Pino Alberti      -  Für seinen superben MailManager...
  428.  
  429.     Robert Hofmann    -  Für seine pionierhaften Leistungen in der MM
  430.                          ARexx-Programmierung und den damit verbundenen Inneren
  431.                          Antrieb und guten Tips für das Programm ...
  432.  
  433.     Cord Moeller      -  Für das Tippen der Docs und das Beta-Testing (auch für die
  434.                          lästigen Feature-Requests ?!)
  435.  
  436.     Erich Weidner     -  Für seine Feature-Requests und Beta-Testing
  437.  
  438.     Andreas Netscher  -  Für seine Feature-Requests und Beta-Testing
  439.  
  440.     Sven Matthias     -  Für seine Feature-Requests und Beta-Testing
  441.  
  442.  
  443. ============================= Archive contents =============================
  444.  
  445. Original  Packed Ratio    Date     Time    Name
  446. -------- ------- ----- --------- --------  -------------
  447.     2273     568 75.0% 03-Nov-96 14:56:54 +MM_AmiHatch.info
  448.       13      13  0.0% 27-Aug-96 18:14:12 +Area.HDR
  449.     2324     548 76.4% 16-Nov-96 13:51:14 +MM_Amihatch.Cfg
  450.      209     156 25.3% 27-Aug-96 18:14:12 +Report.TxT
  451.    12606    4681 62.8% 16-Nov-96 14:07:02 +MM_AmiHatch.DOK
  452.     3730    1301 65.1% 16-Nov-96 13:29:32 +History.txt
  453.      976     352 63.9% 27-Aug-96 18:14:12 +Mirrors.WO?
  454.    18952    6003 68.3% 16-Nov-96 13:55:58 +MM_Amihatch
  455.    18424    5532 69.9% 16-Nov-96 13:54:34 +MM_Amihatch.rexx
  456.    12833    4792 62.6% 16-Nov-96 14:06:46  MM_Amihatch.readme
  457. -------- ------- ----- --------- --------
  458.    72340   23946 66.8% 09-Dec-96 23:06:14   10 files
  459.